Scenario Script Hera 1.3
by Amaikokonut

Prepared for CCSF '21!


May be found at Naturing :: Nurturing (https://naturingnurturing.blogspot.com) and/or Naturing :: Nurturing :: Static (https://naturingnurturing.songua.com) and/or a friendly community archive near you!


If you're going to rehost or redistribute this agent, please leave this readme intact.


If you have any comments, questions, bug reports, or just want to chat, email amaikokonut@songua.com


:: About ::


This is a script originally created for an all-female world. It performs the following functions:

- Exports males and ensures all eggs are female

- Once creatures are old enough, assigns them a score based on their drives. Creatures with lower drives will have a lower score. You must have Creature Nametags installed to see the scores, but the script will function without them.

- Ensures the population continues by impregnating a norn with a mix of genetics from the lowest scoring creatures when the population drops below the limit.

- Alters the life chemical of creatures based on their score, so creatures who cannot take care of themselves age and die quickly while low-scoring creatures stick around longer.

Additionally, this for-release version includes several Magic Words commands (http://naturingnurturing.blogspot.com/2011/11/i-guess-i-should-start-releasing-things.html) to allow the user more control over their world.

:: Basic Commands ::

Hera Pause -- Toggles pause on and off. Paused Hera will stop calculating scores, creating pregnancies, and auto-exporting males, but will continue to ensure all eggs laid are female.

Hera Favor -- This will reduce the selected creature's score next time it is calculated, giving it a greater chance to survive and pass on its genes even if it isn't doing so well.

Hera Score Reset -- Resets all creature's scores to 50, giving them all a chance to start over. Useful if you've recently moved the population to a new metaroom or world. This will go into effect the next time score is calculated.

Hera Difficulty # -- Set a number from 1 (very easy) to 10 (very difficult). This affects how gently or harshly a creature is scored. Default is 5.

:: Advanced Commands ::

Hera Score Rate # -- Set a number from 1 to 100 that will affect how quickly score changes take place. Lower values will cause the score to reflect more current drive levels, while higher values will reflect a creature's drives over a longer period of time. Setting this to 100 will freeze scores in place. Default is 50.

Hera Range #-# -- Set a range of numbers such as 10-90 or 40-60 that defines the 'neutral zone' within which a creature will not see any changes to their lifespan. Creatures with a score lower than the first number will live longer lives, while creatures with a score above the last number will not live as long. Default is 20-90. 

Hera Life #/# --  Set two numbers such as 5/15 or 20/90 representing Reward and Penalty respectively. These numbers affect the amount of life a creature gains or loses if its score falls outside the values set in Hera Range. Suggested values are between 1 and 100 but higher values can be set with caution. Defaults are 50/50.

::::

Hey you! Thank you for actually reading this readme! As a bit of thanks, here is an additional tip. If you want to cheat a little, you can change a creature's score directly by using this bit of caos with the desired creature selected:

targ norn setv name "sfb_score" 0

Replace the '0' with your desired score. It won't take effect until the next calculation cycle and by then it may have changed a bit based on the creature's drives, but it should at least be somewhere in the ballpark of your desired score. You can also make use of this method if you wish to create agents or scripts that affect a creatures' score.


:: Additional Credits ::

A huge thank you to KittyTikara (https://mobularay.blogspot.com) for detailed testing and feedback. This agent would be ten times more confusing without her. 
Additional thanks to Mea for both testing and suggesting the pause command. 


:: Changelog ::
12-13-2020: Added the pause command.
10-30-2017: Overhauled some commands to make them simpler/more intuitive.
	    Changed a bunch of calculations to make them more accurate.
10-18-2017: Fixed a bug where males were not being exported properly!
	    Added commands to tweak difficulty and reward/punishment limits.
10-14-2017: Initial test Release
